home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 7 / Amiga Format AFCD07 (Dec 1996, Issue 91).iso / serious / shareware / programming / emacs-complete / fsf / emacs / vms / vmsbuild < prev    next >
Text File  |  1992-11-06  |  3KB  |  75 lines
  1. How to Compile, Link and Build GNU Emacs under VMS
  2. ==================================================
  3.  
  4. A runnable Emacs on VMS consists of two files, an exe file and a map
  5. file.  (It also refers to a DOC file in the [-.etc] sibling directory.
  6. These files are made automatically and kept straight by Emacs version
  7. number.)
  8.  
  9. For an Emacs being built and tested, these files are `temacs.exe' and
  10. `temacs.dump' in this directory.
  11.  
  12. For an installed Emacs, these files are `emacs.exe' and `emacs.dump' in
  13. the directory above this one.  These names are known only in the file
  14. `emacs.com', also in the [.vms] directory.
  15.  
  16. * Run emacs.com
  17.   This sets up the logical names used by everything else.  You *must*
  18.   run this first. 
  19.  
  20. * Run config.com.
  21.   This will copy vmspaths.h to paths.h then copy [.src]config.h_in to
  22.   config.h and edit it to use the correct version of VMS (4.0, 4.2, 4.4,
  23.   or 5.5).  You should look over the contents of config.h to make sure
  24.   you like the way things are set up.
  25.  
  26. * Run compile.com.
  27.   This will recompile any files that need to be recompiled.  You can
  28.   force it to recompile all C files by giving it an argument (any
  29.   argument).  Or, you can run precomp.com to define a command `ccom'
  30.   that can be used to compile any specific C file you want.
  31.  
  32.   If you compile with optimization, note that in compiler version 3.0
  33.   there is a bug affecting inline functions.  So you must specify
  34.   /OPTIMIZE=NOINLINE when compiling `dispnew.c'.  If you still have
  35.   problems, try using /NOOPT. 
  36.  
  37.   Compilation will give you lots of warnings about symbols longer than
  38.   30 characters.  You must just ignore them.  Alternatively, you can
  39.   compile the C program `vms-pp.c' and run all the .C and .H files
  40.   through that program and then compile the results.  (On VMS versions
  41.   before 4.4, the program is called `vms_pp.c'.)
  42.  
  43.   ***If you use `vms-pp.c', please save the originals .c and .h files
  44.   and distribute them rather than the transformed files if you wish to 
  45.   distribute copies of Emacs.  Help minimize confusion!***
  46.  
  47. * Run link.com.
  48.   This will link the compiled files into `temacs.exe'.  You will get
  49.   lots of linker warnings telling you that there were compiler warnings.
  50.   Just ignore them. 
  51.  
  52. * Run complink.com.
  53.   This will compile and link the files in the [emacs.etc] directory.
  54.   This must be done before `makedoc.com' can be run. 
  55.  
  56. * Run makedoc.com.
  57.   This will create or update the file `[-.etc]doc.'.  This must be done
  58.   if that file does not yet exist or if any of the Emacs C sources or
  59.   preloaded Lisp sources has changed.  It must be done before
  60.   `build.com' is run in order to take effect.
  61.  
  62. * Run build.com. 
  63.   This runs `temacs.exe', initializes it and preloads some Lisp code, and
  64.   dumps the map file `temacs.dump' containing a copy of all the impure
  65.   storage after initialization. 
  66.  
  67. * Run testemacs.com.
  68.   This defines the `runtemacs' command to run `temacs.exe' with its map
  69.   file `temacs.dump'.  This step is optional, and allows you to test
  70.   whether or not emacs is running.
  71.  
  72. To install an Emacs, rename `temacs.dump' as `[-]emacs.dump' and rename
  73.   `temacs.exe' as `[-]emacs.exe'.
  74.  
  75.